Inside Macintosh: QuickDraw GX Printing /

Chapter 2 - Core Printing Features / Core Printing Features Reference

Functions / Creating and Managing Job Objects

GXUnflattenJobFromHdl

You can use the GXUnflattenJobFromHdl function to unflatten a job object that you previously flattened using the GXFlattenJobToHdl function.

gxJob GXUnflattenJobFromHdl (gxJob aJob, Handle aHandle);

aJob

A reference to the job object into which unflattened data is placed.

aHandle

A handle from which the job object is to be read.

function result

The unflattened job object.

DESCRIPTION

The GXUnflattenJobFromHdl function provides your application with a mechanism for retrieving all information associated with a job object from a handle. You should call this function when a user opens a printable document containing a job object that was previously flattened using the GXFlattenJobToHdl function.

In the aJob parameter, you specify a job object in which to place the unflattened job object data. You can specify nil in this parameter to allow QuickDraw GX to create and return a job object for you.

The aHandle parameter specifies the handle from which the job object information is read. You previously specified this handle using the GXFlattenJobToHdl function.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxFlattenVersionTooNew	An attempt to unflatten a job object that was flattened using a later version of QuickDraw GX.
gxPaperTypeNotFound	The paper-type object cannot be located.
collectionVersionErr	Version of the collection object is not compatible with the current version of the Collection Manager.

SEE ALSO

Listing 2-10 on page 2-30 shows how to use the GXUnflattenJobFromHdl function to retrieve a job object from a handle.

You specify a handle in which to save a job object using the GXFlattenJobToHdl function, which is described on page 2-56.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help